home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / bbsee14x.zip / CAT2BBC.DOC < prev    next >
Text File  |  1991-05-17  |  8KB  |  165 lines
  1. This documentation is provided to aid in the use of both READCAT.EXE
  2. and WRITECAT.EXE, included with BBSee.  These two supplemental programs
  3. will be of interest to present and future CATDISK (tm) users.  CATDISK
  4. is a high quality disk cataloging program written by another Canadian
  5. author - Rick Hillier.  It has evolved over the years into a widely used
  6. shareware program.  Those of you who have already cataloged xxx disks
  7. with CATDISK may not wish to switch to BBSee; primarily because of not
  8. wanting to have to re-type in all your file comments.  Not to worry; the
  9. combination of Read/WriteCat will take an ascii listing of your catalog,
  10. generated by CATDISK, and import both the filenames and comments into
  11. your database.
  12.  
  13. This document is not intended as a tutorial on the use of CATDISK. Mr.
  14. Hillier has provided sufficient documentation for this.  There are,
  15. however, several points which bear mentioning.  When saving your catalog
  16. to disk, certain settings MUST exist.
  17.  
  18. (These can be toggled via option #2 from the main menu: "settings and toggles".
  19.  
  20. 1.  For sub-option #3 "set printer report type", choose STATS & COMMENTS.
  21. 2.  For sub-option #6 "current report location", choose DISK
  22. 3.  For sub-option #7 "archive extract setting", choose OFF.
  23.  
  24. Note also, in certain cases, files in the .DTA databases created by Catdisk
  25. will have improper dates. (ex. Sun 0, 2022).  In order for Read/WriteCat to
  26. function properly, you MUST make sure no such dates exist in your Catdisk
  27. ASCII output listing.  An easy way to do this is to sort your catalog by DATE,
  28. and send the output to a disk file for visual inspection.  Any problem files
  29. will likely be found at the start or end of your listing.  If no "offending"
  30. file dates are located, then this ascii listing can be used with Read/WriteCat.
  31. If you DO find such "offending" dates, you MUST edit them; changing them to
  32. an acceptable date; ex 01-01-90. Once you are finished editing, if necessary,
  33. the next step is to run READCAT.
  34.  
  35.  
  36.                  Quick-Start Instructions
  37.                         ------------------------
  38.  
  39. Once all the above conditions are met, only 3 steps remain:
  40.  
  41. 1. READCAT [drive] \ [directory] CATDISK.LST  [drive] \ [directory] TEMPFILE
  42.  
  43. 2. Use BBSee; select Import Directory File option, and import TEMPFILE into
  44.    the unknown category.
  45.  
  46. 3. WRITECAT [drive] \ [directory] CATDISK.LST
  47.  
  48. Once these are done, you can restart BBSee; choose the Make Catalog option,
  49. and save to disk your new and much improved catalog listing.  If you want
  50. additional information about these steps, explanations of the benefits of
  51. using these programs; as well as some cataloging hints; read the remainder
  52. of this document.
  53.  
  54.  
  55.         More Detailed Information About These 3 Steps            
  56.         ---------------------------------------------
  57.  
  58.  
  59. The syntax for READCAT is:
  60.  
  61.     READCAT [drive] \ [directory] CATDISK.LST  [drive] \ [directory] TEMPFILE
  62.  
  63. ex. READCAT c:\cat\catdisk.lst c:\log\tempfile
  64.  
  65.     You run CATDISK out of c:\cat; CATDISK.LST is the name of your catalog
  66.     file listing; you wish to save the file TEMPFILE to c:\log (the directory
  67.     where you keep your bbs file lists.)
  68.  
  69. The next step is to add the information from TEMPFILE into your database
  70. the same way you would add files from any bbs listing. (Using the Import
  71. Directory File option from within BBSee; into the unknown category.)
  72.  
  73. Now your master database contains the file and comment information CATDISK
  74. used to contain; only better!  If any of the filenames contained in your
  75. CATDISK.LST file were already in your master database, the file descriptions
  76. will be compared.  When using CATDISK, you were limited to 30 characters,
  77. and now, descriptions can be several lines long.  Even files that were
  78. originally in your CATDISK.LST file that had NO description, will be given
  79. the description contained in the master database if the same filename is
  80. found.
  81.  
  82. Let me clarify the above powerful features with a simple example:
  83.  
  84. On one of your cataloged disks, you have a file called PKLTE103.ZIP.  When
  85. you originally cataloged this disk with CATDISK, you then entered the
  86. following brief comment:
  87.  
  88.         "compresses EXE and COM files".
  89.  
  90. You have already read several large bbs file listings into BBSee, and several
  91. of them contained the file PKLTE103.  The current description for PKLTE103,
  92. contained in your master database is:
  93.  
  94.         "Compressor program for EXE and COM files from
  95.          Phil Katz.  Can ignore files with overlays,
  96.          uncompress files, operate on wildcards, and more.
  97.          Also contains CHK4LITE - which can tell you which
  98.          files have been compressed using PKLITE.  The
  99.          EXE and COM files can be up to 50% smaller than
  100.          the originals, and still run perfectly.  This
  101.          is a MUST-HAVE utility from the author of PKZIP!"
  102.  
  103. You now run READCAT and convert your CATDISK.LST file to a format readable
  104. by BBSee.  You import this new file (TEMPFILE), and BBSee detects the file
  105. PKLTE103 in it's existing database (with the MUCH better, more informative
  106. file description above.)  This description is now associated with PKLTE103
  107. on your disk, rather than the brief, uninformative comment you supplied.
  108.  
  109. This all may sound well and good, but you want to be able to print out a
  110. NEW catalog of your files, showing these new-and-improved descriptions -
  111. RIGHT?  Well, that is where WRITECAT comes in.  WRITECAT updates the
  112. BBSee master floppy catalog library from the same CATDISK input file.
  113. (This means, don't get rid of your CATDISK.LST file as soon as you run
  114. READCAT on it.)  WRITECAT should be run from the same directory that contains
  115. your BBSEE.CFG file since it reads this file to get database information.
  116.  
  117. The format for WRITECAT is:
  118.  
  119.    WRITECAT [drive] \ [directory] CATDISK.LST
  120.  
  121. ex. WRITECAT c:\cat\catdisk.lst
  122.  
  123. (and remember, you should be typing this from your c:\bbsee directory
  124.  or in whatever directory you installed BBSee)
  125.  
  126. Once this is completed, the master catalog file has been updated showing
  127. not only the filenames and descriptions from your original CATDISK.LST
  128. file, but the disk volume labels where the files came from are also known.
  129. You can now start BBSee, and choose the Make Catalog option; selecting
  130. output sorted by filename, or by volume.  Try it!
  131.  
  132. Remember, longer file descriptions can only replace short ones if the
  133. file in question is already in your master BBSee database.  For this
  134. reason, it is best to read in as many bbs file listings as you can
  135. before running READCAT and WRITECAT.
  136.  
  137. One final tip, if you label your disks in numberical order (1,2,3...10,11,12)
  138. if you sort your catalog by volume you will notice the following order:
  139.  
  140.             1
  141.             10
  142.             2
  143.             3
  144.             .
  145.             .
  146.  
  147. This is happening because a "sort" is done from left to right, and therefore
  148. the "1" in "10" is being shown before the "2".  A simple and effective way
  149. to eliminate this "problem" is to number your disks 001, 002, 003, ... 010...
  150.  
  151.                         --------------------
  152.  
  153. Once you have re-cataloged your existing disks via READCAT and WRITECAT,
  154. it should not be necessary to do this in future.  When you start using
  155. BBSee, you will read in the bbs file listings from any bbs's you presently
  156. download files from.  The filenames and descriptions will already be in
  157. the database, so all that you have to do now, is label your floppies
  158. (which can conveniently be done from within BBSee), and catalog any future
  159. disks from within BBSee.  No more typing in 30 character descriptions
  160. through CATDISK, longer descriptions are ready and waiting in your master
  161. database file.
  162.  
  163. Thanks to Paul Loshuk for creating this document.
  164.  
  165.